home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / CCUA_DBC.ZIP;1 / CCUA.DOC < prev    next >
Encoding:
Text File  |  1992-09-11  |  9.1 KB  |  234 lines
  1. Common User Access edit modifications            [  09/11/1992  ]
  2. -------------------------------------
  3.  
  4.  
  5. What's New:
  6. -----------
  7.  
  8.   The front-end menu system has been completely re-worked:
  9.  
  10.   1)  "+ File " and "- File" are now <PgDn> and <PgUp>.
  11.   2)  Next Record is hot-keyed to <Ctrl-RightArrow>.
  12.   3)  Previous Record is hot-keyed to <Ctrl-LeftArrow>.
  13.   4)  Top Record is now called "First", and is hot-keyed to <Home>.
  14.   5)  Last Record is hot-keyed to <End>.
  15.   6)  Find is now called "Search", and hot-keyed to <Alt-S>.
  16.   7)  Add is now hot-keyed to <Insert>.
  17.   8)  Delete is now hot-keyed to <Delete>.
  18.   9)  Copy is now hot-keyed to <Ctrl-C>.
  19.   10) Edit is now hot-Keyed to <Ctrl-Enter>.
  20.   11) The <F10> (accept record) is also mapped to <Ctrl-Enter>.
  21.       (It makes sense in practice). <F10> still works, too.
  22.   12) The previously undocumented <Alt-V> is now on the menu, and
  23.       allows the end-user to change the delay time before the screen-saver
  24.       activates.
  25.   13) "Swap" is gone, and the code for it has been removed.
  26.       (Ever use it? I didn't think so.)
  27.   14) The do_proc function of the skeleton file has been restructured
  28.       to handle the new hot-keys. In addition, case 13 is gone from
  29.       do_proc, and the previously empty case 12 now handles the screen
  30.       saver.
  31.  
  32.   !!! ********************************************************* !!!
  33.       ***    LAST-MINUTE ADDITION    *****    READ THIS    ****
  34.       *********************************************************
  35.  
  36.       The do_proc function in CCUA.SKL now contains cases 101-116.
  37.       These cases switch instantly to files 1 through 16 (case
  38.       number minus 100).
  39.  
  40.       This makes it possible to instantly switch between files,
  41.       not necessarily in sequence.
  42.  
  43.       For example, say you had a 3-file database where
  44.         File #1 = Invoices
  45.         File #2 = Customers
  46.         File #3 = Products
  47.  
  48.       Now, if you wanted to make a pull-down menu that could access
  49.       any of the three files at random, you would add three items to
  50.       the CCUA.MEN menu's "File" pull-down:
  51.  
  52.    Item Prompt: "Invoices"    Execution Action: "P"   Procedure #: 101
  53.    Item Prompt: "Customers"   Execution Action: "P"   Procedure #: 102
  54.    Item Prompt: "Products"    Execution Action: "P"   Procedure #: 103
  55.  
  56.    Try it, it works!
  57. ------------------------------------
  58.  
  59.  
  60. You should have the following files:
  61.  
  62. CCUA.DOC      -- This documentation file.
  63. CCUA.MEN      -- CUA-compliant menu system.
  64. CCUA.DBW      -- Background screen template.
  65. CCUA.SKL      -- CUA-compliant modified skeleton file.
  66.  
  67. DB_FUNCS.C    --  [ These are modified copies of the original units
  68. DB_KEY.H      --    from DataBoss 3.5. Changes are marked with:
  69. DB_UTIL.C     --
  70. DB_MEMO.C     --        { [DG] 09/10/92 -- <explanation> }            ]
  71.  
  72.  
  73. --------------------------------------
  74.  
  75. How to install:
  76.  
  77.   Copy all these files to your main DataBoss C directory. The four .C files will overwrite the existing ones, so you may wish to save a
  78.   copy of the originals. Your apps will still compile just fine with the
  79.   modified .C files and the original DBP.SKL and DBPMENU.DMU, but the
  80.   Ctrl-Enter, Tab, and Shift-Tab keys will retain their special functions.
  81.   (More on that in a moment).
  82.  
  83.   After you have copied the new .C and .H files into your DataBoss C
  84.   directory, run the "NEWLIB" batch file to reconstruct the DataBoss
  85.   library with the changed files.
  86.  
  87.   The syntax for NEWLIB is:
  88.  
  89.     NEWLIB <memory model> <compiler manufacturer> <compiler> <librarian>
  90.  
  91. Example:
  92.   Borland C/C++:
  93.     NEWLIB L B C:\BORLANDC\BIN\BCC.EXE C:\BORLANDC\BIN\TLIB.EXE
  94.   Turbo C/C++:
  95.     NEWLIB L B C:\TC\BIN\TCC.EXE C:\TC\BIN\TLIB.EXE
  96.   Microsoft C 7.0:
  97.     NEWLIB L M C:\C700\BIN\CL.EXE C:\C700\BIN\LIB.EXE
  98.   Quick-C:
  99.     NEWLIB L M C:\QC25\BIN\QCL.EXE C:\QC25\BIN\LIB.EXE
  100.  
  101.  
  102.  
  103. ---------------------------------------
  104.  
  105. How to use this package:
  106.  
  107.    Design your apps as you normally would. For the sake of convenience, I
  108.    have designed a background template (CCUA.DBW) which works very well
  109.    with the redesigned menu system. Copy of CCUA.DBW to a work directory,
  110.    and rename it to the name of your application. Design your app normally
  111.    from there. If you use blue windows with white double-line borders and
  112.    yellow text, the "look + feel" will be very similar to the Borland
  113.    programming language editors.
  114.  
  115.    Once you have finished your app, Generate/Compile it. On the Generate
  116.    pop-up window, there is a line which reads: "Create <myfile>.C using
  117.    skeleton file DBC.SKL". Replace the DBC.SKL with CCUA.SKL. Also, under
  118.    the "Command Menu Name" should be CCUA.MEN, instead of DBPMENU.DMU.
  119.  
  120.    Generate the code with these settings, compile, and enjoy!
  121.  
  122. ----------------------------------------
  123.  
  124. CCUA.DBW explanation:
  125.  
  126.   CCUA.DBW is a simple beginning to a database application. There are no
  127.   windows, and no fields defined. This file contains only a background
  128.   window, which is a backdrop for the application. It was designed to
  129.   look like the Borland editors, and maintains the same structure and
  130.   color scheme.
  131.  
  132.   All you need to do is copy CCUA.DBW into a working directory. You will
  133.   probably wish to rename it, to something which matches your application.
  134.   Then, you define fields and windows normally. I suggest a blue window
  135.   white double-borders and yellow text (just like Borland's IDE).
  136.  
  137.   Alternatively, you could use a white window with black text, and use
  138.   the DBATTR.EXE program to set the Active Video (highlight bar) to
  139.   black text on green, Inactive Video to white text on blue, and Edit
  140.   Video to white text on green, mimicking the look of the Turbo IDE's
  141.   dialog boxes.
  142.  
  143. ---------------------------------
  144.  
  145. CCUA.MEN explanation:
  146.  
  147.   This is the replacement for DBPMENU.DMU, which is also modeled after the
  148.   look and feel of a Borland menu system. Here's how it works:
  149.  
  150.   The main menu bar looks like this:
  151.    ______________________
  152.      File  Record  Edit
  153.    ----------------------
  154.  
  155.   The File menu contains the following options:
  156.  
  157.   Item         Hot Key
  158.   -----------|----------
  159.   Next         <PgDn>  : This is equivalent to DBPMENU's  "+ File"  option.
  160.                          Next will move you to the next accessible file in
  161.                          the database.
  162.  
  163.   Previous     <PgUp>  : This is equivalent to DBPMENU's  "- File"  option.
  164.                          Previous will move you to the preceding file in the
  165.                          database.
  166.  
  167.   Screen Save  <Alt-V> : This feature was present, but not documented, in
  168.                          the original skeleton and menu system. This allows
  169.                          the end-user to change the time before the screen
  170.                          saver appears.
  171.  
  172.   Exit         <Alt-X> : This exits the database, just like the "Quit"
  173.                          option in DBPMENU. The Alt-X hotkey is retained.
  174.  
  175.  
  176.   The Record menu contains the following options:
  177.  
  178.   Item         Hot Key
  179.   -----------|----------
  180.   Next         <Ctrl-RArr>  : This is equivalent to DBPMENU's "Next" option.
  181.                               It will move you to the next record in the
  182.                               current data file. (If there is no pull-down
  183.                               menu active, the up arrow will also do this.)
  184.  
  185.   Previous     <Ctrl-LArr>  : This is equivalent to DBPMENU's "Prev" option.
  186.                               It will move you to the preceding record in
  187.                               the current data file. (If there is no
  188.                               pull-down menu active, the down arrow will
  189.                               also do this.)
  190.  
  191.   First        <Home>       : This is equivalent to DBPMENU's "Top" option.
  192.                               It will move you to the first available
  193.                               record in the current data file.
  194.  
  195.   Last         <End>        : This is equivalent to DBPMENU's "Last" option.
  196.                               It will move you to the last available
  197.                               record in the current data file.
  198.  
  199.   Search       <Alt-S>      : This is equivalent to DBPMENU's "Find" option.
  200.                               It brings up the "Find Record" query system.
  201.  
  202.  
  203. The Edit menu contains the following options:
  204.  
  205.   Item         Hot Key
  206.   -----------|----------
  207.   Add          <Ins>        : Adds a record to the current data file.
  208.  
  209.   Delete       <Del>        : Removes the current record from the current
  210.                               data file.
  211.  
  212.   Edit         <Ctrl-Enter> : Allows the current record to be edited.
  213.  
  214.   Copy         <Ctrl-C>     : Copies the current record, and allows the
  215.                               copy to be edited.
  216.  
  217.  
  218. ------------------------------------
  219.  
  220. CUA.SKL changes:
  221.  
  222.    do_menu has been restructured to handle the new key mappings, and the
  223.    Swap function is gone from do_proc. That's about it....
  224.  
  225. ------------------------------------
  226.  
  227.   Enjoy!
  228.  
  229.   Justin Kaufman and David Gonzalez
  230.  
  231.  
  232. ** "Borland", "Turbo", "Turbo Pascal", and "IDE" are trademarks of
  233.    Borland International, Scotts Valley, CA.                       **
  234.